Soul Shard Manager (WoW Classic 20주년 / 불타는 성전 기념일 서버용)

Game Version: WoW Classic 1.15.8, TBC 2.5.5
Version: 1.0.0 (2026. 2. 23.)

───────────────────
1. 애드온 개요
───────────────────
■ Soul Shard Manager는 흑마법사의 필수 아이템인 '영혼의 조각' 개수를 실시간으로 모니터링하고 가방 공간을 효율적으로 관리해 주는 전문 애드온입니다.

■ 접속한 클라이언트 언어(한국어/영어)를 자동으로 감지하여 모든 UI 메시지와 툴팁을 해당 언어로 출력합니다.

■ 직관적인 UI 색상 변화와 원클릭 파괴 기능을 통해 전투와 파밍 중에도 끊김 없는 조각 관리를 지원합니다.

───────────────────
2. 주요 기능
───────────────────
■ 스마트 모니터링 UI
 - 영혼의 조각 아이콘과 현재 개수를 중앙에 표시
 - 상태별 텍스트 색상 변화 (청록색: 한도 초과, 녹색: 한도 도달, 노란색: 6개 이상, 빨간색: 5개 이하)
 - 조각 부족 경보: 조각이 5개 이하가 되면 화면 중앙에 공격대 경보 메시지를 출력하고 효과음을 재생

■ 영혼의 조각 원클릭 파괴 및 가방 보호
 - 블리자드 보안 제약을 우회하는 보조 버튼 로직을 통해 마우스 좌클릭 한 번으로 초과 조각을 1개씩 즉시 파괴
 - 가방 보호: 전용 영혼 가방 내의 조각은 파괴 대상에서 제외하여 안전하게 보호
 - 삭제할 조각이 일반 가방에 없거나 한도 이하일 경우 버튼을 회색으로 비활성화

■ 편의 기능 (버튼 잠금 상태에서 작동)
 - 크기 토글 (Shift+마우스 우클릭): 버튼 크기를 36x36(기본)에서 60x60(확대)으로 즉시 전환하며 폰트 크기도 함께 조절
 - 조각 정렬 (Ctrl+마우스 우클릭): 일반 가방에 흩어진 조각들을 영혼 가방의 빈 칸으로 우선 정렬

───────────────────
3. 사용 방법
───────────────────
■ 마우스 조작
 - 좌클릭: 초과된 조각을 1개씩 즉시 파괴 (삭제 대상이 일반 가방에 있을 때만 작동)
 - 우클릭: 버튼 잠금/해제 토글 (해제 시 녹색 테두리가 나타나며 이동 가능)
 - Shift+우클릭: 버튼 크기 확대/축소 (잠금 상태에서만 작동)
 - Ctrl+우클릭: 일반 가방의 조각을 영혼 가방으로 자동 이동 (잠금 상태에서만 작동)

■ 명령어
 - /영혼조각 또는 /ssmanager: 도움말 및 현재 상태 확인
 - /영혼조각 설정 [숫자] 또는 /ssmanager set [숫자]: 보유 한도 설정 (기본값: 20)
 - /영혼조각 활성화|비활성화 또는 /ssmanager on|off: 애드온 켜기/끄기

───────────────────
4. 데이터 저장 구조
───────────────────
■ SoulShardManagerDB: 캐릭터별 설정 정보를 저장
 - 보유 한도 개수
 - 버튼 크기 확대 여부
 - 애드온 활성화 상태
 - 흑마법사 직업 확인 정보

───────────────────
5. 설치 방법
───────────────────
■ 아래와 같은 폴더 구조로 설치하세요.

Interface
└── AddOns
    └── SoulShardManager
          ├── SoulShardManager.lua
          ├── SoulShardManager.toc
          ├── SoulShardManager_Vanilla.toc
          ├── SoulShardManager_TBC.toc
          └── README.txt

■ 게임 내 ‘애드온’ 탭에서 [Soul Shard Manager]가 활성화되어 있는지 확인합니다.

───────────────────
6. 변경 이력
───────────────────
■ 1.0.0 (2026. 2. 23.)
 - 영혼의 조각 보유 한도 설정
 - 실시간 개수 표시 UI
 - 보조 일반 버튼을 활용한 보안 우회 및 원클릭 파괴
 - 전용 가방에 있는 영혼의 조각을 보호
 - 조각이 5개 이하일 때 공격대 경보
 - Shift+우클릭으로 버튼 크기(36↔60) 및 폰트 크기 토글
 - Ctrl+우클릭으로 일반 가방의 조각을 영혼 가방 안에 정렬

───────────────────
7. 주의사항
───────────────────
■ 전투 시에는 버튼의 매크로 상태가 변경되지 않으므로 조각 파괴 명령이 실행되지 않으며, 위치나 크기 토글 역시 보안 정책에 의해 작동하지 않습니다.

■ 전투 중이라도 한도 초과 여부나 보유 개수에 따른 버튼의 표시 내용은 실시간으로 갱신되며, 영혼 가방으로의 조각 정렬 기능도 사용 가능합니다.

───────────────────
8. 저작권 및 이용 조건
───────────────────
■ 개인 목적에 한해 자유롭게 사용 가능

■ 개발자 표기

■ 상업적 이용 및 무단 전재/재배포 금지

───────────────────
9. 개발자 정보
───────────────────
■ Author: Goyathlay, 20주년 기념일 펜구스의 흉포 KR 호드

■ Contact: 인게임 우편/디스코드
